Skip to content

docs(cli): document the app store and the rest of the pilotctl surface#52

Merged
TeoSlayer merged 1 commit into
mainfrom
pilotctl-help-audit
Jun 25, 2026
Merged

docs(cli): document the app store and the rest of the pilotctl surface#52
TeoSlayer merged 1 commit into
mainfrom
pilotctl-help-audit

Conversation

@Alexgodoroja

Copy link
Copy Markdown
Collaborator

Problem

The CLI reference and App Store guide had drifted from pilotctl:

  • cli-reference documented pilotctl set-tags / clear-tags as core commands, but they are extras-gated (pilotctl extras set-tags).
  • cli-reference omitted the App Store command family, plus verify, recovery, prefer-direct, update, and review.
  • app-store omitted the view, caps, actions, and bundle-verify subcommands.

Changes

docs/cli-reference

  • New App Store section (catalogue / view / install / list / call / status / caps / audit / actions / restart / uninstall / verify / gen-key / sign / sign-catalogue) + TOC entry.
  • New Verification & Recovery section (verify, recovery) + TOC entry.
  • Add prefer-direct (Diagnostics), update and review (Meta).
  • Fix the Tags section to pilotctl extras set-tags / clear-tags.

docs/app-store

  • Document view in the install flow, caps + actions in Lifecycle, and bundle verify in the sideload section.

Plain mirrors (plain/docs/*) updated to match — note scripts/regen-plain.mjs does not cover these two pages, so they were edited directly.

Verification

  • npm run build passes (all pages built, no errors).
  • Spot-checked the rendered HTML: the new sections (#appstore, #verification, #prefer-direct, …) and subcommands render in both the main and plain pages; tags now show pilotctl extras set-tags.

The CLI reference and app-store guide had drifted from pilotctl:

- cli-reference documented `pilotctl set-tags` / `clear-tags` as core,
  but they are extras-gated (`pilotctl extras set-tags`).
- cli-reference omitted the App Store family, verify, recovery,
  prefer-direct, update, and review.
- app-store omitted the view, caps, actions, and bundle-verify
  subcommands.

Add an App Store section and a Verification & Recovery section to the
CLI reference (plus prefer-direct under Diagnostics, update and review
under Meta), fix the tags invocation to `pilotctl extras set-tags`, and
document view/caps/actions/verify in the app-store guide. Plain mirrors
updated to match. `npm run build` passes.
@github-actions

Copy link
Copy Markdown

🚀 Preview deployed to Cloudflare Pages

  • Commit deploy URL: https://34bbc9ca.pilotprotocol.pages.dev
  • Branch alias: https://pilotctl-help-audit.pilotprotocol.pages.dev (may take ~30s to propagate)
  • Commit: 8e3298a07b4be210c1839f609208eb29573e13d9

@TeoSlayer TeoSlayer merged commit cd13f4b into main Jun 25, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants